5.2.1 MINPAYウォレットへの出金注文の作成
#簡単な説明: ウォレットの出金ビジネスインターフェースに人民元またはデジタル通貨を引き出し、ユーザーがアカウント残高を指定されたウォレットアドレスに送金できるようにします。
- リクエスト方法：POST
- リクエストインターフェイス: https://gateway-domain/wallet-trade-merchant/v1/pay/wallet/create ・リクエストメディアタイプ(JSONデータ形式)Content-Type: application/json
リクエストパラメータ
| パラメータ名 | タイプ | 必須 | パラメータの意味 | パラメータの説明 |
|---|---|---|---|---|
key | string | はい | 販売者キー | APIキー |
localOrderId | string | はい | 販売者プラットフォームのローカル注文番号 | 販売者プラットフォームはローカルで一意の注文番号を生成します。 |
localUserId | string | いいえ | 販売者プラットフォームのローカル ユーザー ID | 販売者プラットフォームのローカル ユーザー ID |
amount | number | はい | 注文金額 | 出金金額 |
email | string | いいえ | 退会メールアドレス | ユーザーの電子メール アドレス (ユーザー ID2 で 1 を選択) |
userId | string | いいえ | ユーザーID | ユーザーの電子メール (ユーザー ID2 で 1 を選択) |
notifyUrl | string | いいえ | コールバックアドレス | 注文が正常に行われた後、販売者のアドレスは API コールバックによって通知されます (コールバックの詳細については、ドキュメント 3 を参照してください)。 |
currency | string | はい | サポートされている通貨 | 通貨（ウォレット対応通貨） |
successRedirectUrl | string | いいえ | 住所 | 成功後に自動的にアドレスにジャンプします。 |
expireSecond | Long | いいえ | 有効期限のタイムスタンプ (秒) | |
sign | string | はい | 署名 | 詳細については、「署名アルゴリズム」を参照してください。 |
JSON サンプルをリクエスト
{
"key": "08SaKUwNafSOc8w7",
"localOrderId": "2023102400684344447",
"localUserId": "302199873005",
"email": "diamond8888@gmail.com",
"amount": "100",
"currency": "CNY",
"successRedirectUrl": "WWW.BAIDU.COM",
"notifyUrl": "www.baidu.com/notify/callback",
"sign": "41c48ea2951934626b4435f02aecf732"
}
応答 json の例
{
"code": 0,
"success": true,
"message": "string",
"data": {
"orderId": "2023102400684344447",
"localOrderId": "2023102400684344447",
"localUserId": "302199873005",
"withdrawBizType": "WITHDRAW_WALLET",
"orderType": "PAYMENT",
"toUserId": 4603
}
}
応答データパラメータの説明
| パラメータ名 | タイプ | パラメータの意味 | 備考 |
|---|---|---|---|
orderId | string | 注文ID | |
localUserId | string | 販売者のローカル ユーザー ID | |
localOrderId | string | 販売者のローカル注文番号 | |
orderType | enum | 注文タイプ | |
orderBizType | enum | 受注業態 | orderBizType タイプの説明は次のとおりです。 |
toUserId | number | 決済ユーザーID | MINPAYウォレットのユーザーID |
orderBizType タイプの説明:
- PAYMENT_WALLET_SCAN MINPAYウォレットスキャンコード支払い
- PAYMENT_TRANSFER デジタル通貨バインディングアドレス直接入金
- PAYMENT_ANY_DIGITAL_SCAN QR コードをスキャンして、任意の金額のデジタル通貨を支払います
- WITHDRAW_WALLET MINPAY ウォレットにお金を引き出します
- WITHDRAW_ANY_DIGITAL_WALLET デジタル通貨を任意のウォレットに引き出します
- PAYMENT_FIXED_DIGITAL_SCAN デジタル通貨限定金額スキャンコード支払い
- BATCH_PAY 一括支払い
コールバックは JSON データを返します
デフォルトでは、すべての callback パラメータが署名検証に参加します。コールバックパラメータの詳細については、「コールバック](/docs/dx-docs/3、回调)」を参照してください。
コールバックデータ
{
"amount":"4",
"bizType":"WITHDRAW_WALLET",
"currency":"USDT",
"localOrderId":"conan41123",
"merchantActualAmount":"31.45",
"merchantCurrency":"USDT",
"merchantId":302992856974,
"merchantPaidAmount":"4",
"merchantUserId":"conan",
"notifyTime":1772364467800,
"orderCreateTime":1772364292167,
"orderId":"474083263103237",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"28.37",
"userCurrency":"USDT",
"userReceivableAmount":"28.37",
"walletUserId":4603,
"sign":"bc92191367449df36920178e05731a6b",
"key":"9yUreYgTRtit39Dy"
}
コールバック通知を受信した場合は、処理が完了した後、メッセージが正常に受信され処理されたことを示す文字列 success を直接返してください。 システムが成功応答を受信すると、コールバックを繰り返し送信しなくなります。 予期した応答が受信されない場合 (成功が返されないか、例外が返された場合)、システムは段階的再試行メカニズムに従ってコールバック通知を再送信し、最大 14 回再試行します。 現在の再試行間隔は次のとおりです。 15秒、15秒、30秒、180秒、600秒、1200秒、1800秒、1800秒、1800秒、3600秒、10800秒、10800秒、21600秒、21600秒